/*
 * Copyright 2025 The JA-SIG Collaborative. All rights reserved.
 * distributed with this file and available online at
 */
package com.lap.auth.adapter.driven.web.role;

import com.lap.auth.application.role.RoleDataScopeAppService;
import com.lap.auth.application.role.command.CreateDataScopeCmd;
import com.lap.auth.application.role.dto.RoleDataScopeDto;
import com.lap.watchdog.starter.annotation.RepeatSubmit;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.*;

/**
 * 提供restful接口层:
 *
 * <ol>
 *   <li>业务规则，原则上不做任何业务逻辑处理，仅仅是技术入口
 *   <li>命名规则，语义上明确接口做什么，推荐使用 Restful 命名 + Verb风格方法名（适配Swagger、Spring）:
 *       <ul>
 *         <li>分页使用 getXXXPage
 *         <li>获取单个 getXXById
 *         <li>保存使用 createXX
 *         <li>更新使用 updateXX
 *         <li>删除使用 deleteXX
 *       </ul>
 * </ol>
 *
 * @author Shuisheng Lao(劳水生)
 * @version 0.0.1
 */
@Tag(name = "角色数据权限管理", description = "提供角色数据权限基本操作，查询等")
@RequiredArgsConstructor
@RestController
@RequestMapping("api/v1/roles")
public class RoleDataScopeController {

  private final RoleDataScopeAppService roleDataScopeAppService;

  @Operation(summary = "获取角色数据权限")
  @GetMapping("{roleId}/data-scope")
  public RoleDataScopeDto getRoleDataScopes(@PathVariable Integer roleId) {
    return roleDataScopeAppService.getRoleDataScopes(roleId);
  }

  @Operation(summary = "授权角色数据权限")
  @RepeatSubmit
  @PutMapping("{roleId}/data-scope")
  public void updateDataScope(@PathVariable Integer roleId, @RequestBody CreateDataScopeCmd cmd) {
    roleDataScopeAppService.saveDataScope(roleId, cmd);
  }
}
